home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / watch102.zip / WATCH102.DOC < prev    next >
Text File  |  1990-11-11  |  19KB  |  521 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.               ┌───────────────────────────────────────────────────────┐
  11.               │                                                       │
  12.               │                                                       │
  13.               │                   W A T C H . E X E                   │
  14.               │                                                       │
  15.               │                          and                          │
  16.               │                                                       │
  17.               │                  W A T C H C . E X E                  │
  18.               │                                                       │
  19.               │                                                       │
  20.               │          The Mini Program Execution Profiler          │
  21.               │                                                       │
  22.               │                     Documentation                     │
  23.               │                                                       │
  24.               │        Compliments of: DSE Software Publishing        │
  25.               │                                                       │
  26.               │         ╔═══════════════════════════════════╗         │
  27.               │         ║ ▀▀▀▀▀▀▀▀       ▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀ ║         │
  28.               │         ║  ▀▀▀    ▀     ▀▀    ▀▀  ▀▀▀    ▀▀ ║         │
  29.               │         ║  ▀▀▀     ▀   ▀▀      ▀  ▀▀▀     ▀ ║         │
  30.               │         ║  ▀▀▀     ▀▀  ▀▀         ▀▀▀       ║         │
  31.               │         ║  ▀▀▀     ▀▀  ▀▀▀        ▀▀▀  ▀    ║         │
  32.               │         ║  ▀▀▀     ▀▀   ▀▀▀       ▀▀▀  ▀    ║         │
  33.               │         ║  ▀▀▀     ▀▀     ▀▀▀     ▀▀▀▀▀▀    ║         │
  34.               │         ║  ▀▀▀     ▀▀       ▀▀▀   ▀▀▀  ▀    ║         │
  35.               │         ║  ▀▀▀     ▀▀        ▀▀▀  ▀▀▀  ▀    ║         │
  36.               │         ║  ▀▀▀     ▀▀         ▀▀  ▀▀▀       ║         │
  37.               │         ║  ▀▀▀     ▀   ▀      ▀▀  ▀▀▀     ▀ ║         │
  38.               │         ║  ▀▀▀    ▀    ▀▀    ▀▀   ▀▀▀    ▀▀ ║         │
  39.               │         ║ ▀▀▀▀▀▀▀▀      ▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀ ║         │
  40.               │         ╚═══════════════════════════════════╝         │
  41.               │                                                       │
  42.               │                DSE Software Publishing                │
  43.               │                      P.O. Box 96                      │
  44.               │                Willits, CA 95490-0096                 │
  45.               │                    (707) 459-4358                     │
  46.               │                                                       │
  47.               └───────────────────────────────────────────────────────┘
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.          Microsoft(R), MS-DOS(R), and QuickBASIC(R) are registered
  58.          trademarks belonging to Microsoft Corporation. IBM(R) and PC-
  59.          DOS(R) are registered trademarks belonging to International
  60.          Business Machines.  TesSeRact(tm) is a trademark of TesSeRact
  61.          Development Team.  ProWindows(tm) and HyperNotes(tm) are
  62.          trademarks of DSE Software Publishing.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.          INTRODUCTION
  70.  
  71.               Thank you for downloading a copy of the WATCH utilities, our
  72.               "Mini Program Execution Profilers".
  73.  
  74.               The WATCH utilities are simple utilities that allow you to
  75.               track the exact execution time of a program and the manner in
  76.               which it returned control back to DOS.  But whatever you use
  77.               the WATCH utilities for, keep this in mind:
  78.  
  79.  
  80.          WARRANTY
  81.  
  82.               This product is sold "AS IS" and DSE Software Publishing
  83.               specifically disclaims all warranties, expressed or implied,
  84.               including but not limited to implied warranties of
  85.               merchantability and fitness for a particular purpose.  In no
  86.               event shall DSE Software Publishing and/or the author Daniel
  87.               P. Stasinski be liable for any loss of profit or any other
  88.               commercial damage, including but not limited to special,
  89.               incidental, consequential or other damages.
  90.  
  91.               In layman's terms: "If lightening strikes your wife's cat
  92.               while you are using WATCH, it is purely coincidence, and we
  93.               really don't care".
  94.  
  95.  
  96.          AND FURTHER MORE
  97.  
  98.               DSE Software Publishing has placed this utility into the
  99.               Public Domain.  You may use it, give it away, sell it for up
  100.               to $100,000 per copy, or dance on it under a full moon in
  101.               July.  All we ask is that you don't remove our name from it.
  102.  
  103.               If you have any questions or comments about this program,
  104.               feel free to contact us at any time.  We can be reached in
  105.               the following ways:
  106.  
  107.               1).  Fnet (FoReM) messages can be addressed to "PROWINDOWS"
  108.                    at Node #387 (Ukiah, California), or through "The MS-
  109.                    DOS(R) Programmer's Conference" available on CrossNet
  110.                    (Conference Code: 20387).
  111.  
  112.               2).  BBS Support at (707) 463-2418.  Messages can be
  113.                    addressed to "PROWINDOWS".
  114.  
  115.               3).  GE-Mail (GEnie) messages can be addressed to
  116.                    "DSE.SOFTWARE".
  117.  
  118.               4).  Voice support is available Monday through Friday, 12:00
  119.                    PM to 5:00 PM (Pacific) at (707) 459-4358.
  120.  
  121.               5).  US Mail is by far the slowest but may be addressed to:
  122.  
  123.                         DSE Software Publishing
  124.                         P.O. Box 96
  125.                         Willits, CA 95490-0096
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.          BACKGROUND
  135.  
  136.               The WATCH utilities (WATCH.EXE and WATCHC.EXE) are used to
  137.               monitor the total execution time of a program.  One version
  138.               will also return the test program's termination code, and the
  139.               manner in which it was terminated (no, these aren't the same
  140.               thing).
  141.  
  142.               Both WATCH utilities were written in 100% assembly language.
  143.               Unlike a couple if similar utilities (Written in C), the
  144.               WATCH utilities dynamically shrink themselves just prior to
  145.               running.
  146.  
  147.  
  148.          WATCH.EXE
  149.  
  150.               WATCH.EXE executes a program directly, and does not require a
  151.               secondary DOS shell.  It is able to run in less than 2980
  152.               bytes of RAM.  It's only drawback is that it does not seem to
  153.               be able to process some standard DOS utilities (ie, XCOPY,
  154.               FORMAT, and others).  It may also not work with utilities
  155.               that require wildcards (* or ?).  This is due to the way
  156.               these utilities parse the DOS command line.
  157.  
  158.               When correctly used, WATCH.EXE will return the following
  159.               information:
  160.  
  161.                    Command      : PROGRAM.EXE parameters
  162.                    Start Date   : MM/DD/YY
  163.                    Start Time   : HH:MM:SS.ms
  164.                    Stop Time    : HH:MM:SS.ms
  165.                    Elapsed Time : HH:MM:SS.ms
  166.                    Termination  : Normal | Device Error | TSR | Ctrl-Break
  167.                    Return Code  : 0 to 255
  168.  
  169.  
  170.          WATCHC.EXE
  171.  
  172.               WATCHC.EXE executes a program by loading a secondary DOS
  173.               shell, and executing the test program through it.  It's
  174.               drawbacks are that the 2nd COMMAND.COM uses additional
  175.               memory (around 4000 bytes more).  It's major drawback is that
  176.               the time it takes to load the 2nd copy of COMMAND.COM may
  177.               somewhat taint the "Elapsed time" results.  This version
  178.               will, however, work will all DOS utilities.
  179.  
  180.               When correctly used, WATCHC.EXE will return the following
  181.               information:
  182.  
  183.                    Command      : PROGRAM.EXE parameters
  184.                    Start Date   : MM/DD/YY
  185.                    Start Time   : HH:MM:SS.ms
  186.